mergCL
Type
library
Description
mergCL is an iOS external for LiveCode that implements significant location change and region monitoring. Both of these services from the CoreLocation framework will start your app in the background if it's not running when the location event occurs. For this external to function reliably the exits on suspend key of the apps plist must be removed.
Associated Syntax
Command
| Name | Summary | Syntax |
|---|---|---|
| mergCLStartLocationManager | Start the location manager | mergCLStartLocationManager <pPurpose>, [<pAuthorizationType>] |
| mergCLStartMonitoringRegion | mergCLStartMonitoringRegion <pIdentifier>, <pLocation>, <pRadius>, <pDesiredAccuracy> | |
| mergCLStopMonitoringRegion | mergCLStopMonitoringRegion <pIdentifier> | |
| mergCLRequestRegionStatus | This command requests the core location framework determine if the user is inside or outside the region | mergCLRequestRegionStatus <pRegionIdentifier> |
| mergCLStartMonitoringBeaconRegion | mergCLStartMonitoringBeaconRegion <pIdentifier>, <pProximityUUID>, <pMajor>, <pMinor> | |
| mergCLStartRangingBeaconsInRegion | mergCLStartRangingBeaconsInRegion <pIdentifier>, <pProximityUUID>, [<pMajor>], [<pMinor>] | |
| mergCLStopRangingBeaconsInRegion | mergCLStopRangingBeaconsInRegion <pIdentifier> | |
| mergCLRequestBeaconRegionStatus | This command requests the core location framework determine if the user is inside or outside the region | mergCLRequestBeaconRegionStatus <pRegionIdentifier> |
| mergCLBroadcastBeacon | mergCLBroadcastBeacon <pIdentifier>, <pProximityUUID>, <pMajor>, <pMinor> | |
| mergCLStartMonitoringSignificantLocationChanges | mergCLStartMonitoringSignificantLocationChanges | |
| mergCLStopMonitoringSignificantLocationChanges | mergCLStopMonitoringSignificantLocationChanges | |
| mergCLStartMonitoringVisits | Recieve the mergCLVisit message when a the system detects a new visit related event | mergCLStartMonitoringVisits |
| mergCLStopMonitoringVisits | Stop monitoring vor visit events | mergCLStopMonitoringVisits |
| mergCLGeocode | Request the placemarks found when searching for the address string | mergCLGeocode <pAddressString> |
| mergCLReverseGeocode | Request the placemarks found when searching for the location | mergCLReverseGeocode <pCoordinate> |
Message
| Name | Summary | Syntax |
|---|---|---|
| mergCLAuthorizationChanged | This message is sent to the object that started the location manager when the authorization status of location services changes | mergCLAuthorizationChanged <pStatus> |
| mergCLRegionEntered | This message is sent to the object that started the location manager when a monitored region is entered | mergCLRegionEntered <pIdentifier>, <pLocation>, <pRadius> |
| mergCLRegionExited | This message is sent to the object that started the location manager when a monitored region is exited | mergCLRegionExited <pIdentifier>, <pLocation>, <pRadius> |
| mergCLRegionMonitoringFailed | This message is sent to the object that started the location manager when region monitoring fails for a specific region | mergCLRegionMonitoringFailed <pIdentifier>, <pLocation>, <pRadius>, <pError> |
| mergCLBeaconRegionEntered | This message is sent to the object that started the location manager when a monitored region is entered | mergCLBeaconRegionEntered <pIdentifier>, <pProximityUUID>, <pMajor>, <pMinor> |
| mergCLBeaconRegionExited | This message is sent to the object that started the location manager when a monitored region is exited | mergCLBeaconRegionExited <pIdentifier>, <pProximityUUID>, <pMajor>, <pMinor> |
| mergCLBeaconRegionMonitoringFailedForRegion | This message is sent to the object that started the location manager when region monitoring fails for a specific region | mergCLBeaconRegionMonitoringFailedForRegion <pIdentifier>, <pProximityUUID>, <pMajor>, <pMinor>, <pError> |
| mergCLDidRangeBeacons | This message is sent to the object that started the location manager when beacons are ranged | mergCLDidRangeBeacons <pRangedBeacons> |
| mergCLLocationChanged | This message is sent to the object that started the location manager when the device location significantly changes | mergCLLocationChanged <pLocation> |
| mergCLVisit | This message is sent to the object that started the location manager when a visit event is detected | mergCLVisit <pLocation>, <pArrivalDate>, <pDepartureDate> |
| mergCLGeocodeResult | This message is sent to the object that called mergCLGeocode when the query returns from the server | mergCLGeocodeResult <pResult> |
| mergCLGeocodeResult | This message is sent to the object that called mergCLGeocode when the query returns from the server | mergCLGeocodeResult <pResult> |
Function
| Name | Summary | Syntax |
|---|---|---|
| mergCLIsRegionMonitoringAvailable | mergCLIsRegionMonitoringAvailable() | |
| mergCLMaximumRegionMonitoringDistance | mergCLMaximumRegionMonitoringDistance() | |
| mergCLMonitoredRegions | mergCLMonitoredRegions() | |
| mergCLCoordinateWithin | mergCLCoordinateWithin(<pTestCoordinate>, <pCenterCoordinate>, <pRadius>) | |
| mergCLIsBeaconRegionMonitoringAvailable | mergCLIsBeaconRegionMonitoringAvailable() | |
| mergCLIsBeaconRegionRangingAvailable | mergCLIsBeaconRegionRangingAvailable() | |
| mergCLMonitoredBeaconRegions | mergCLMonitoredBeaconRegions() | |
| mergCLRangedBeaconRegions | mergCLRangedBeaconRegions() | |
| mergCLSignificantLocationChangeMonitoringAvailable | mergCLSignificantLocationChangeMonitoringAvailable() | |
| mergCLDistanceBetween | Calculate the distance between to coordinates taking into account the curvature of the earth | mergCLDistanceBetween(<pCoordinateFrom>, <pCoordinateTo>) |